home *** CD-ROM | disk | FTP | other *** search
/ Atari Forever 3 / Atari Forever 3 / Atari Forever 3.iso / PD_THEMA / ACCESSOR / DISK6.ZIP / TERMIN / TERMIN.DOC < prev    next >
Encoding:
Text File  |  1990-02-11  |  6.4 KB  |  143 lines
  1.  
  2.  
  3.                            TERMIN.ACC / TERMIN.PRG
  4.                              Terminuhr für den ST
  5.                                  Version 2.0
  6.                          (C) Klaus Rittmeier  2/1990
  7.  
  8.  
  9.  
  10.    Dieses kleine Programm habe ich geschrieben, weil die gängigen Terminkalen-
  11.  der für den ST entweder sehr groß geraten ( und damit Speicherfresser ) sind,
  12.  oder sehr lange Termindateien erzeugen ( also Diskettenfresser sind ).
  13.  Außerdem bieten jene Programme meist nur die Möglichkeit, an einem bestimmten
  14.  Datum zu einer bestimmten Uhrzeit eine Meldung zu bringen, und das auch nur
  15.  innerhalb von sauber programmierten GEM-Applikationen.
  16.  
  17.  
  18.  
  19.   TERMIN.ACC folgt einem anderen Konzept:
  20.  
  21.   * Eine Terminmeldung ( Alarm ) kommt in jedem Fall, unabhängig davon, was
  22.     gerade für ein Programm läuft.
  23.   * Die Termindatei ist eine einfache Textdatei und deshalb nur so lang,
  24.     wie ihre Einträge beanspruchen.
  25.   * In das Programm ist ein einfacher Fullscreen-Texteditor integriert, der
  26.     die Bearbeitung der Termindatei ermöglicht.
  27.   * Im Speicher werden nur die Termine resident gehalten, die für den jewei-
  28.     ligen Tag aktuell sind.
  29.   * Es können auch Termine gespeichert werden, die regelmäßig wiederkehren.
  30.  
  31.  
  32.  ACHTUNG :
  33.  Die ordnungsgemäße Funktion der Terminuhr ist nur gewährleistet, wenn Sie
  34.  die Betriebssystemuhr Ihres Rechners richtig gestellt haben !
  35.  Dafür gibt es genügend Programme, z.B. das Kontrollfeld 'CONTROL.ACC', daß
  36.  zum Lieferumfang des ST gehört.
  37.  
  38.  
  39.  ab Version 2.0 :
  40.  - volle GEM-Einbindung ( echtes Fensterhandling )
  41.  
  42.  
  43.  Das Programm kann als Applikation ( TERMIN.PRG ) oder als Desk-Accessory
  44.  ( TERMIN.ACC ) gestartet werden. Beide Betriebsarten unterscheiden sich
  45.  jedoch :
  46.  
  47.    Bei der Applikation werden keine Routinen resident im Speicher installiert.
  48.  Deshalb funktioniert die Terminuhr nur solange das Programm läuft.
  49.  Andererseits steht der Applikation der volle Arbeitsspeicher zur Verfügung,
  50.  sodaß die gesamte Termindatei geladen und ediert werden kann.
  51.  
  52.    Für das Accessory wird nur ein Speicher von 2 kB als Textspeicher reser-
  53.  viert. Deshalb werden nur die Termine aus der Termindatei geladen, die für den
  54.  entsprechenden Tag aktuell sind. Das Edieren der gesamten Datei ist deshalb
  55.  in dieser Betriebsart nicht möglich, neue Termine können der Datei jedoch
  56.  hinzugefügt werden.
  57.  
  58.  
  59.  
  60.    Wie sieht nun solch eine Termindatei aus ?
  61.  
  62.    Es ist eine einfache ASCII-Textdatei. Sie muß die Bezeichnung "TERMIN.INF"
  63.  tragen und sich im gleichen Verzeichnis wie das Programm befinden.
  64.  In dieser Datei stehen in ungeordneter Reihenfolge Terminnotizen ( wie auf ei-
  65.  nem Pinboard ). Diese Notizen bestehen aus Tagesangaben und zu jedem Tag eine
  66.  oder mehrere Uhrzeiten mit je einem beliebig langen Kommentar.
  67.  
  68.  Beim Layout müssen Sie folgendes beachten :
  69.  
  70.    * Eine Tagesangabe beginnt mit einem '#', gefolgt von einem Datum in der
  71.      Schreibweise tt.mm.jjjj oder tt.mm.jj ( z.B. #3.9.89 ), oder einer
  72.      Wochentagsangabe. Als Wochentagsangabe werden folgende Schlüsselwörter
  73.      erkannt :   #Montag
  74.                  #Dienstag
  75.                  #Mittwoch
  76.                  #Donnerstag
  77.                  #Freitag
  78.                  #Samstag
  79.                  #Sonntag
  80.                  #Täglich und #täglich
  81.                  #Werktags und #werktags
  82.                  #heute.
  83.      Signifikant bei der Wochentagsangabe sind nur die ersten beiden Buchsta-
  84.      ben. Die Groß-/ Kleinschreibung muß eingehalten werden.
  85.  
  86.    * Eine Uhrzeit wird in der Form hh:mm oder hh:mm:ss angegeben ( z.B. 6:25 ).
  87.  
  88.    * Zwischen Tagesangabe, Uhrzeit und Kommentar muß mindestens je ein "white
  89.      space" ( Leerzeichen, Tabulator oder newline ) stehen.
  90.      Hinter einer Tagesangabe können mehrere Termine ( Uhrzeit und Kommentar )
  91.      eingetragen werden. Der Kommentar sollte in der gleichen Zeile wie die
  92.      Uhrzeit stehen.
  93.  
  94.  
  95.  
  96.   Die Handhabung des Programms ist einfach :
  97.  
  98.   Am besten kopieren Sie TERMIN.ACC auf die Bootdiskette und installieren es
  99.   als Desk-Accessory.
  100.   Das Programm lädt die Datei "TERMIN.INF" nach und sucht nach Terminen, die
  101.   für den Tag aktuell sind.
  102.   Durch Selektieren des Menüeintrags "Terminuhr" wird das Editorfenster geöff-
  103.   net und Sie können sich die Termine für den Tag ansehen, bzw. neue Termine
  104.   hinzufügen. Der Text wird automatisch alle zwei Sekunden nach gültigen Termi-
  105.   nen durchsucht. Mittels F10 verlassen Sie das Editorfenster wieder.
  106.  
  107.   Wollen Sie einer Termindatei neue Einträge hinzufügen, so müssen Sie wissen,
  108.   daß bei Wahl der Funktion "speichern" ( F2 ) der gesamte Inhalt des Textpuf-
  109.   fers an die alte Datei "TERMIN.INF" angehängt wird. Gehen Sie also folgender-
  110.   maßen vor :
  111.   Löschen Sie mittels ^ClrHome ( Control-Taste und ClrHome-Taste gleichzeitig
  112.   drücken ) den Textpuffer, tragen Sie die neuen Termine ein und drücken Sie
  113.   F2. Die Termine werden dann gespeichert und anschließend werden die aktuellen
  114.   Termine automatisch wieder geladen.
  115.  
  116.   Mittels der Tasten F4 und F5 können Sie im Terminkalender blättern und mittels
  117.   F6 Termine für ein bestimmtes Datum heraussuchen.
  118.   Sie sollten es jedoch vermeiden, Termine zu ergänzen, wenn Sie im Fenster
  119.   gerade nicht das aktuelle Datum eingestellt haben. Wenn das Fenster geschlos-
  120.   ssen wird, sind diese Termine futsch ( Es sei denn, Sie haben Sie abgespei-
  121.   chert ).
  122.   Haben Sie das Datum verändert und wollen wieder zurück zum aktuellen Datum:
  123.   Doppelklick ins Fenster reicht.
  124.  
  125.   Wer sich die Belegung der Funktionstasten nicht merken kann, der drückt ein-
  126.   fach die Help-Taste. Die Funktionen können dann in einer Dialogbox auch
  127.   per Mausklick gewählt werden.
  128.  
  129.  
  130.   Die eigentliche Terminuhr läuft in einem Interruptprogramm im Hintergrund,
  131.   unabhängig von der Art der gerade laufenden Applikation. Stimmt ein Termin
  132.   mit der aktuellen Uhrzeit überein, so ertönt eine Melodie. In GEM-Programmen
  133.   erscheint auch einen Alarmbox mit der Uhrzeit und dem zugehörigen Eintrag.
  134.   Es wird als Eintrag jedoch maximal die Zeile ausgegeben, in der auch die
  135.   Uhrzeit steht. Sollte der Eintrag länger sein, so müssen Sie halt das Acces-
  136.   sory aufrufen und nachschauen.
  137.   In TOS-Programmen oder GEM-Programmen ohne Ereignisabfrage ertönt im Alarm-
  138.   fall nur die Melodie. Die Alertbox wird jedoch nachträglich ausgegeben, so-
  139.   bald Sie das Programm verlassen.
  140.   
  141.   Die Genauigkeit der Terminuhr beträgt zwei Sekunden. Die Eintragungen in der
  142.   Termindatei können jedoch mit beliebiger Genauigkeit gemacht werden.
  143.